.TH "hark" "1" "Aug 2009" "hark-0.2" "hark"
.SH "NAME"
hark \- Gentoo: Package Query and Checking Tool
.SH "SYNOPSIS"
.B hark
.I [option] [pattern]
.PP

.SH "DESCRIPTION"
hark is a command line driven query tool for the package database 
on a Gentoo Linux system.  


.SH "OPTIONS"
hark provides a number of different command line options (either
in POSIX or GNU long format) to specify queries to the package 
database. Currently, the following options are available:


.TP 4m
.PD 0
\fI-d PACKAGE 
.TP
.PD
\fI--find-depends-used PACKAGE\fR


Search for all installed packages depending on PACKAGE. Here, 
PACKAGE can either be a simple package name or a category/package 
name specifier. In addition, a version specifier or an EAPI 
style slot can be specified. Hence, the following are examples
of valid depend queries

.nf
tcl
dev-lang/tcl
tcl-8.2
dev-lang/tcl-8.2
x11-libs/fltk:1.1
.ni

If multiple installed packages match PACKAGE, hark will complain
with a request to un-ambiguate the call, e.g., via adding an
explicit package category, version, or slot.

Please note that in contrast to equery, hark will also consider
the USE flags of each possible dependency. That is, package
dependencies qualified with a USE flag will only be considered
true dependencies if that USE flag was present during the emerge
of the package.

.TP 4m
.PD 0
\fI-D PACKAGE\fR 
.TP
.PD
\fI--find-depends-all PACKAGE\fR

Like -d, but all dependencies are listed, no matter if requested
by a USE flag or not. 

.TP 4m
.PD 0
\fI-f PACKAGE\fR
.TP
.PD
\fI--show-all-content PACKAGE\fR

Show all files installed by package PACKAGE. PACKAGE 
can either be a simple package name or a category/package 
name specifier. In addition, a version specifier or an EAPI 
style slot can be specified.


.I NOTE:
hark will always only print the content of a single package 
at a time and complain if a request matches more than a single 
package. 


.TP 4m
.PD 0
\fI-F SPEC PACKAGE\fR
.TP
.PD
\fI--show-restricted-content SPEC PACKAGE \fR

Like --show-files but only displays files in category SPEC.
Currently, the following SPECs are known:

.nf
b  : list binaries /usr/bin, /usr/sbin, /bin, /sbin
d  : list docs in /usr/share/doc
e  : list files in /etc
i  : list include files in /usr/include
l  : list libraries in /lib, /lib/64, /usr/lib, /usr/lib64
s  : list files in /usr/share
.ni


.TP 4m
.PD 0
\fI-o FILEPATH\fR
.TP
.PD
\fI--show-files FILEPATH\fR

Show the package who owns the file located at FILEPATH. FILEPATH
has to be absolute and hark currently does not follow symbolic
links, with exception of /usr/lib and /lib symlinked to 
/usr/lib64 and /lib64, respectively, on 64bit installs.


.TP 4m
.PD 0
\fI-s STRING\fR 
.TP
.PD
\fI--find-package-short STRING\fR

Search for all installed package with STRING in their name. 
Please note that regular expressions are not allowed in STRING
and will be escaped to allow proper matching of packages like
gtk+ and the like. 

.RS 4m
.I Example: 
If STRING is equal to "libc", possible matches would include 

.nf
dev-libs/libcroco-0.6.1 and 
sys-libs/glibc-2.8_p20080602.
.ni
.RE


.TP 4m
.PD 0
\fI-S STRING\fR 
.TP
.PD
\fI--find-package-detailed STRING\fR

Like -s but will provide additional information for all found
packages. Currently, hark returns [KEYWORD | REPOSITORY | DATE]
prefixing each returned package name. Here,

.nf
KEYWORD   : keyword with which package was emerged
REPOSITORY: repository from which ebuild for package was taken; 
            g == main portage tree, o = any other.
DATE      : date and time at which package was installed
.ni 

Please not that since the additional information requires hark
to open additional files, the detailed search will in general be
slower than a plain search.


.TP 4m
.PD 0
\fI-u USE\fR 
.TP
.PD
\fI--find-use-all USE\fR

Shows all packages that have use flag USE no matter if that
use flag was turned on or not during the emerge of the
package.


.TP 4m
.PD 0
\fI-U USE\fR 
.TP
.PD
\fI--find-use-used USE\fR

Like -u but only displays packages that were actually emerged
with this USE flag turned on.


.TP 4m
.PD 0
\fI-v\fR
.TP
.PD
\fI--version-info\fR

Shows a brief version information.


.TP 4m
.PD 0
\fI-h\fR
.TP
.PD
\fI--help\fR

Shows a brief help summary.


.SH "REPORTING BUGS"

Please report bugs to <haskelladdict@gmail.com>


.SH "COPYRIGHT AND LICENSE"

hark is released under the GPL version 3.
There is NO warranty; not even for MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE.

(C) 2008-2009 Markus Dittrich


.SH "AUTHOR"
.nf
Markus Dittrich <haskelladdict@gmail.com>
.fi
